home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / sar.z / sar
Encoding:
Text File  |  2002-10-03  |  13.6 KB  |  329 lines
  1.  
  2.  
  3.  
  4. SSSSAAAARRRR((((1111))))                                                                  SSSSAAAARRRR((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sar - system activity reporter
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssaaaarrrr [----uuuubbbbddddDDDDFFFFyyyyccccwwwwaaaaqqqqvvvvmmmmpppprrrrttttgggghhhhIIIIAAAAUUUUTTTTRRRR] [----oooo file] t [ n ]
  13.  
  14.      ssssaaaarrrr [----uuuubbbbddddDDDDFFFFyyyyccccwwwwaaaaqqqqvvvvmmmmpppprrrrttttgggghhhhIIIIAAAAUUUUTTTTRRRR] [----ssss time] [----eeee time] [----iiii sec] [----ffff file]
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _s_a_r, in the first instance, samples cumulative activity counters in the
  18.      operating system at _n intervals of _t seconds, where _t should be 5 or
  19.      greater.  If the ----oooo option is specified, it saves the samples in _f_i_l_e in
  20.      binary format.  The default value of _n is 1.  In the second instance,
  21.      with no sampling interval specified, ssssaaaarrrr extracts data from a previously
  22.      recorded _f_i_l_e, either the one specified by ----ffff option or, by default, the
  23.      standard system activity daily data file ////vvvvaaaarrrr////aaaaddddmmmm////ssssaaaa////ssssaaaa_d_d for the current
  24.      day _d_d.  The starting and ending times of the report can be bounded via
  25.      the ----ssss and ----eeee _t_i_m_e arguments of the form _h_h[:_m_m[:_s_s]].  The ----iiii option
  26.      selects records at _s_e_c second intervals.  Otherwise, all intervals found
  27.      in the data file are reported.
  28.  
  29.      In either case, subsets of data to be printed are specified by option:
  30.  
  31.      ----uuuu   Report CPU utilization (the default):
  32.           The system-wide average of the statistics reported by -U.
  33.  
  34.      ----UUUU   Report per-CPU utilization statistics:
  35.           %usr, %sys, %intr, %wio, %idle, %sbrk - portion of each cpu's time
  36.           running in user mode, running in system mode, processing interrupts,
  37.           idle and waiting for I/O, completely idle or idle with some process
  38.           waiting because system memory is scarce, respectively.  These six
  39.           percentages add up to 100%.  The time that the processor spent in
  40.           ``idle waiting for I/O'' state is further broken down into the
  41.           following categories:
  42.           %wfs - waiting for filesystem I/O
  43.           %wswp - waiting for swap I/O to complete
  44.           %wphy - waiting for physio other than swapping
  45.           %wgsw - waiting for graphics context switch to complete
  46.           %wfif - waiting while graphics pipe too full
  47.           These five numbers add up to 100% of the %wio time.
  48.  
  49.           Prior to the IRIX 6.5.13 release, a processor was considered
  50.           ``waiting for I/O'' if it was idle and there was any I/O outstanding
  51.           on the system.  Beginning with the IRIX 6.5.13 release, a processor
  52.           is only considered ``waiting for I/O'' if it is idle and any of the
  53.           outstanding I/O was initiated on that particular processor.  Reports
  54.           generated from system activity daily data files (////vvvvaaaarrrr////aaaaddddmmmm////ssssaaaa////ssssaaaa_d_d)
  55.           created prior to the IRIX 6.5.13 release will reflect the old data.
  56.           This change results in no difference on uniprocessor machines.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. SSSSAAAARRRR((((1111))))                                                                  SSSSAAAARRRR((((1111))))
  70.  
  71.  
  72.  
  73.      ----bbbb   Report buffer activity:
  74.           bread/s, bwrit/s - basic blocks transferred between system buffers
  75.           and disk or other block devices;
  76.           lread/s, lwrit/s - basic blocks transferred from system buffers to
  77.           user memory;
  78.           wcncl/s - pending writes in system buffers cancelled;
  79.           %rcach, %wcach - cache hit ratios, that is, (1-bread/lread) as a
  80.           percentage;
  81.           pread/s, pwrit/s - basic block transfers via raw (physical) device
  82.           mechanism.
  83.  
  84.      ----dddd   See also ----DDDD and ----FFFF below.  Report activity for block devices (i.e.
  85.           disk drives).  The activity data reported is:
  86.           device - /dev/dsk device name (sans parition)
  87.           %busy - % of time device was busy performing I/O requests;
  88.           avque - average number of I/O requests outstanding;
  89.           r+w/s - number of read AND write I/O requests per second;
  90.           blks/s - number of 512-byte blocks (basic block) read AND written;
  91.           w/s - number of write I/O requests per second;
  92.           blks/s - number of 512-byte blocks (basic block) written;
  93.           avwait - average time in ms. that I/O requests wait idly on queue;
  94.           avserv - average time in ms. to service I/O requests (which for
  95.           disks includes seek, rotational latency and data transfer time).
  96.  
  97.      ----DDDD   This option is identical to ----dddd above except that it does not report
  98.           idle disks (disks that transferred no data blocks).
  99.  
  100.      ----FFFF   This option is only meaningful in conjunction with ----dddd or ----DDDD.  It is
  101.           designed to be used with fabric devices that have long names that
  102.           would make line formatting uneven.  It causes the device name to be
  103.           printed on the right of the output lines rather than on the left.
  104.  
  105.      ----yyyy   Report TTY device activity:
  106.           rawch/s, canch/s, outch/s - input character rate, input character
  107.           rate processed by canon, output character rate;
  108.           rcvin/s, xmtin/s, mdmin/s - receive, transmit and modem interrupt
  109.           rates.
  110.  
  111.      ----cccc   Report system calls:
  112.           scall/s - system calls of all types;
  113.           sread/s, swrit/s, fork/s, exec/s - specific system calls;
  114.           rchar/s, wchar/s - characters transferred by read and write system
  115.           calls.
  116.  
  117.      ----wwww   Report system swapping and switching activity:
  118.           swpin/s, swpot/s, bswin/s, bswot/s - number of transfers and number
  119.           of 512-byte units transferred for swapins and swapouts (including
  120.           initial loading of some programs);
  121.           pswpout/s - process swapouts
  122.           pswch/s - process (user thread) switches.
  123.           kswch/s - kernel thread switches.
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. SSSSAAAARRRR((((1111))))                                                                  SSSSAAAARRRR((((1111))))
  136.  
  137.  
  138.  
  139.      ----gggg   Report graphics activity:
  140.           gcxsw/s - graphics context switches per second
  141.           ginpt/s - graphics input driver calls per second
  142.           gintr/s - graphics interrupts other than FIFO interrupts per second
  143.           fintr/s - FIFO too full interrupts per second
  144.           swpbf/s - swap buffers calls per second
  145.  
  146.      ----aaaa   Report use of file access system routines:
  147.           iget/s, namei/s, dirblk/s.
  148.  
  149.      ----qqqq   Report average queue length while occupied, and % of time occupied:
  150.           runq-sz, %runocc - run queue of processes in memory and runnable;
  151.           swpq-sz, %swpocc - swap queue of processes swapped out but ready to
  152.           run;
  153.           wioq-sz, %wioocc - queue of processes waiting for I/O.
  154.  
  155.           Prior to the IRIX 6.5.13 release, %wioocc was the percent of wall-
  156.           clock time that any process was waiting for I/O.  Beginning with the
  157.           IRIX 6.5.13 release, %wioocc is the average of each processor's time
  158.           spent with I/O outstanding.
  159.  
  160.           The reported wioq-sz also changed.  Prior to the IRIX 6.5.13
  161.           release, it was the average number of processes on the system
  162.           waiting for I/O when any wio queue was occupied.  It is now the
  163.           weighted average of the average length of each processor's wio queue
  164.           when that queue is occupied, weighted by the amount of time that
  165.           that queue was occupied.
  166.  
  167.           In reports generated with a current ssssaaaarrrr from data files from before
  168.           this change, and in reports generated with an old ssssaaaarrrr from new data
  169.           files, the %wioocc field is invalid.
  170.  
  171.      ----vvvv   Report status of process, i-node, file tables and record lock
  172.           tables:
  173.           proc-sz, inod-sz, file-sz, lock-sz - entries/size for each table,
  174.           evaluated once at sampling point;
  175.           ov - overflows that occur between sampling points for each table.
  176.  
  177.      ----mmmm   Report message and semaphore activities:
  178.           msg/s, sema/s - primitives per second.
  179.  
  180.      ----pppp   Report paging activities:
  181.           vflt/s - address translation page faults (valid page not in memory);
  182.           dfill/s - address translation fault on demand fill or demand zero
  183.           page;
  184.           cache/s - address translation fault page reclaimed from page cache;
  185.           pgswp/s - address translation fault page reclaimed from swap space;
  186.           pgfil/s - address translation fault page reclaimed from filesystem;
  187.           pflt/s - (hardware) protection faults -- including illegal access to
  188.           page and writes to (software) writable pages;
  189.           cpyw/s - protection fault on shared copy-on-write page;
  190.           steal/s - protection fault on unshared writable page;
  191.  
  192.  
  193.  
  194.                                                                         PPPPaaaaggggeeee 3333
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201. SSSSAAAARRRR((((1111))))                                                                  SSSSAAAARRRR((((1111))))
  202.  
  203.  
  204.  
  205.           rclm/s - pages reclaimed by paging daemon.
  206.           Dfill, cache, pgswp, and pgfil are subsets of vflt; cpyw and steal
  207.           are subsets of pflt.
  208.  
  209.      ----tttt   Report translation lookaside buffer (TLB) activities:
  210.           tflt/s - user page table or kernel virtual address translation
  211.           faults:  address translation not resident in TLB;
  212.           rflt/s - page reference faults (valid page in memory, but hardware
  213.           valid bit disabled to emulate hardware reference bit);
  214.           sync/s - TLBs flushes on all processors;
  215.           vmwrp/s - syncs caused by clean (with respect to TLB) kernel virtual
  216.           memory depletion;
  217.           flush/s - single processor TLB flushes;
  218.           idwrp/s - flushes because TLB ids have been depleted;
  219.           idget/s - new TLB ids issued;
  220.           idprg/s - tlb ids purged from process;
  221.           vmprg/s - individual TLB entries purged.
  222.  
  223.      ----rrrr   Report unused memory pages and disk blocks:
  224.           freemem - average pages available to user processes;
  225.           freeswap - disk blocks available for process swapping;
  226.           vswap - virtual pages available to user processes.
  227.  
  228.      ----hhhh   Report system heap statistics:
  229.           heapmem - amount of memory currently allocated to all kernel dynamic
  230.           heaps (block managed arenas, general zone heaps, and private zone
  231.           heaps);
  232.           overhd - block managed arena overhead;
  233.           unused - block managed arena memory available for allocation;
  234.           alloc/s - number of allocation requests per second;
  235.           free/s - number of free requests per second.
  236.  
  237.      ----IIII   Report interrupt statistics:
  238.           intr/s - non-vme interrupts per second;
  239.           vmeintr/s - vme interrupts per second;
  240.  
  241.      ----RRRR   Report memory statistics
  242.           physmem - physical pages of memory on system;
  243.           kernel - pages in use by the kernel;
  244.           user - pages in use by user programs;
  245.           fsctl - pages in use by filesystem to control buffers;
  246.           fsdelwr - pages in use by filesystem for delayed-write buffers;
  247.           fsdata - pages in use by filesystem for read-only data buffers;
  248.           freedat - pages of free memory that may be reclaimable;
  249.           empty - pages of free memory that are empty.
  250.  
  251.      ----AAAA   Report all data.  Equivalent to ----uuuuddddqqqqbbbbwwwwccccaaaayyyyvvvvmmmmpppprrrrttttgggghhhhIIIIUUUURRRR.
  252.  
  253.      ----TTTT   Report total counts instead of just percentages or per-second
  254.           values.  The counts are calculated by taking the difference between
  255.           the start and end values in the data file.
  257.  
  258.  
  259.                                                                         PPPPaaaaggggeeee 4444
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266. SSSSAAAARRRR((((1111))))                                                                  SSSSAAAARRRR((((1111))))
  267.  
  268.  
  269.  
  270. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  271.      To see today's CPU activity so far:
  272.  
  273.           sar
  274.  
  275.      To watch CPU activity evolve for 10 minutes and save data:
  276.  
  277.           sar -o temp 60 10
  278.  
  279.      To later review disk activity from that period:
  280.  
  281.           sar -d -f temp
  282.  
  283.      To show total disk activity from that period:
  284.  
  285.           sar -T -d -f temp
  286.  
  287. FFFFIIIILLLLEEEESSSS
  288.      /var/adm/sa/sa_d_d
  289.                     daily data file, where _d_d are digits representing the day
  290.                     of the month.
  291.  
  292. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  293.      gr_osview(1), osview(1), sar(1M)
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                                                         PPPPaaaaggggeeee 5555
  326.  
  327.  
  328.  
  329.